package com.ruoyi.campus.service;

import com.ruoyi.campus.domain.UserExtend;
import java.util.List;
import java.util.Map;

/**
 * 用户扩展信息Service接口
 * 
 * @author ruoyi
 * @date 2024-01-17
 */
public interface IUserExtendService
{
    /**
     * 查询用户扩展信息
     * 
     * @param userId 用户扩展信息主键
     * @return 用户扩展信息
     */
    public UserExtend selectUserExtendByUserId(Long userId);

    /**
     * 查询用户扩展信息列表
     * 
     * @param userExtend 用户扩展信息
     * @return 用户扩展信息集合
     */
    public List<UserExtend> selectUserExtendList(UserExtend userExtend);

    /**
     * 查询用户扩展信息详情（包含关联信息）
     * 
     * @param userId 用户ID
     * @return 用户扩展信息
     */
    public UserExtend selectUserExtendDetail(Long userId);

    /**
     * 根据学号查询学生
     * 
     * @param schoolId 学校ID
     * @param studentNumber 学号
     * @return 用户扩展信息
     */
    public UserExtend selectStudentByNumber(Long schoolId, String studentNumber);

    /**
     * 根据工号查询教师
     * 
     * @param schoolId 学校ID
     * @param teacherNumber 工号
     * @return 用户扩展信息
     */
    public UserExtend selectTeacherByNumber(Long schoolId, String teacherNumber);

    /**
     * 根据微信openid查询用户
     * 
     * @param openid 微信openid
     * @return 用户扩展信息
     */
    public UserExtend selectUserExtendByOpenid(String openid);

    /**
     * 查询学校的用户列表
     * 
     * @param schoolId 学校ID
     * @param userType 用户类型
     * @return 用户扩展信息集合
     */
    public List<UserExtend> selectUsersBySchool(Long schoolId, Integer userType);

    /**
     * 查询学生列表
     * 
     * @param schoolId 学校ID
     * @param className 班级名称
     * @param grade 年级
     * @return 用户扩展信息集合
     */
    public List<UserExtend> selectStudents(Long schoolId, String className, String grade);

    /**
     * 查询教师列表
     * 
     * @param schoolId 学校ID
     * @param department 部门
     * @param subject 科目
     * @return 用户扩展信息集合
     */
    public List<UserExtend> selectTeachers(Long schoolId, String department, String subject);

    /**
     * 查询家长列表
     * 
     * @param schoolId 学校ID
     * @return 用户扩展信息集合
     */
    public List<UserExtend> selectParents(Long schoolId);

    /**
     * 查询用户类型统计
     * 
     * @param schoolId 学校ID
     * @return 统计信息集合
     */
    public List<Map<String, Object>> selectUserTypeStatistics(Long schoolId);

    /**
     * 查询用户年龄分布统计
     * 
     * @param schoolId 学校ID
     * @return 统计信息集合
     */
    public List<Map<String, Object>> selectAgeStatistics(Long schoolId);

    /**
     * 查询班级统计
     * 
     * @param schoolId 学校ID
     * @return 统计信息集合
     */
    public List<Map<String, Object>> selectClassStatistics(Long schoolId);

    /**
     * 新增用户扩展信息
     * 
     * @param userExtend 用户扩展信息
     * @return 结果
     */
    public int insertUserExtend(UserExtend userExtend);

    /**
     * 修改用户扩展信息
     * 
     * @param userExtend 用户扩展信息
     * @return 结果
     */
    public int updateUserExtend(UserExtend userExtend);

    /**
     * 批量删除用户扩展信息
     * 
     * @param userIds 需要删除的用户扩展信息主键集合
     * @return 结果
     */
    public int deleteUserExtendByUserIds(Long[] userIds);

    /**
     * 删除用户扩展信息信息
     * 
     * @param userId 用户扩展信息主键
     * @return 结果
     */
    public int deleteUserExtendByUserId(Long userId);

    /**
     * 批量导入用户
     * 
     * @param userList 用户列表
     * @param updateSupport 是否更新支持
     * @return 结果消息
     */
    public String importUser(List<UserExtend> userList, Boolean updateSupport);

    /**
     * 校验学号/工号唯一性
     * 
     * @param userExtend 用户信息
     * @return 结果
     */
    public boolean checkNumberUnique(UserExtend userExtend);

    /**
     * 重置用户密码
     * 
     * @param userId 用户ID
     * @param password 密码
     * @return 结果
     */
    public int resetUserPwd(Long userId, String password);

    /**
     * 修改用户状态
     * 
     * @param userExtend 用户信息
     * @return 结果
     */
    public int updateUserStatus(UserExtend userExtend);
} 